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Greetings: 


Thank you for choosing IBM* to help you meet your networking needs with the VTAM™* program. For the first time, we are 
offering you VTAM in three packages: VTAM Client/Server, VTAM MultiDomain, and VTAM InterEnterprise. 


This decision marks the beginning of a new era for VM and VSE users of VTAM. Now you can choose a package based on 
the set of capabilities you need in your particular network. Each package is designed to maximize performance and reduce 
your networking costs, because you pay only for the functions you need. 


If you have chosen VTAM Client/Server, you get the full Advanced Program-to-Program (APPC) and Advanced Peer-to-Peer 
Networking* (APPN*) capabilities on the host. These functions allow your host to be a server in peer networking environments. 


Not only do you get the APPN and APPC functions essential for distributed peer networking, you also get the powerful con- 
nection options that VTAM users have come to rely on over time. Clients can be on any number of different line types and 
receive the full support of VTAM. 


APPN dynamics, ease of use, and SNA power and reliability combine to offer you a valuable networking solution for 
client/server networks. 


If you have chosen VTAM MultiDomain, our package of choice, you receive a set of functions designed to accommodate the 
networking needs of a large network. In addition to the capabilities available in VTAM Client/Server, VTAM MultiDomain gives 
you what you need for networks with multiple domains. 


If you have chosen VTAM InterEnterprise, you get functions that build on those offered in VTAM Client/Server and VTAM 
MultiDomain to help you meet the needs of inter-enterprise, interconnected networks. With this package, you have the VTAM 
functions you need to manage and control interconnected networks. 


The information that accompanies your package covers all of the functions VTAM offers. To help you determine what informa- 
tion applies to your package, use this flyer as a quick reference to the functions your package supports. It is intended to be 
used along with the books in the VTAM product library. 


Regardless of the package you have chosen, we want you to be satisfied with our product. As always, we appreciate your 
business and look forward to hearing from you if you think we can help you in any way. Please feel free to contact us through 
the reply card at the end of every book in the VTAM product library. 


Sincerely, 
Spee 


Susan Orr 
VTAM Product Manager 


* Trademark of IBM Corporation. 


About This Flyer 


This flyer describes the new way in which VTAM is packaged 
for the VM/ESA* and VSE/ESA* operating systems. It tells 
you about: 


e Ordering VTAM initially 
e Changing your package 
e Starting VTAM. 


For each package, this flyer lists the functions included. For 
VTAM Client/Server and VTAM MultiDomain, it also lists the 
keywords, start options, and operands that are not sup- 
ported. 


Use this flyer along with the VTAM product library to help 
you understand which information applies to you. 


How VTAM V4R2 Is Packaged 


When you order VTAM V4R2 for VM/ESA and VSE/ESA, you 
choose one of three packages: 


e VTAM Client/Server 
e VTAM MultiDomain 
¢ \VTAM InterEnterprise. 


VTAM Client/Server is designed for client/server networks 
that require basic APPN and subarea support. If a function 
is not listed here under any package, you can assume that it 
is included in VTAM Client/Server. 


VTAM MultiDomain includes the functions available in VTAM 
Client/Server along with additional APPN and subarea func- 
tions, such as the capability to own an NCP. 


VTAM InterEnterprise includes the functions available in 
VTAM Client/Server and VTAM MultiDomain along with the 
APPN and subarea functions that are required in an intercon- 
nected network. 


For users in a combined VM/ESA and VSE/ESA environ- 
ment, you can order VTAM for VM as a feature of VTAM for 
VSE at a special price. You can order VTAM for VSE first 
and VTAM for VM later on, or you can order them simultane- 
ously. Either way, you can take advantage of this special 
offer. 


Ordering VTAM Initially 


When you place your order for the package you want, you 
receive with the package some information, which includes a 
password. You need this password to start VTAM. For 
instructions, see “Starting VTAM.” 
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Changing to a Different Package 


If you deci“e you want a different package from the one you 
are running, you need to see any of the following for informa- 
tion on how to place your order: 


VTAM product announcement materials 
The ordering system configurator 

IBM Sales Manual 

Your IBM representative. 


When you place your order, you need the following informa- 
tion: 


e Your IBM customer number 
e The VTAM Version 4 program number: 


— VTAM Version 4 for VM/ESA: 5654-010 
— VTAM Version 4 for VSE/ESA: 5686-065 
— \VTAM VM Feature for VSE/ESA: 5686-065 


e The feature order number for the package you want. 
(See the VTAM product announcement materials.) 


After you place your order, you will receive your password, 
which you need to start VTAM. For instructions, see 
“Starting VTAM.” 


Starting VTAM 


_When you start VTAM, the following message confirms which 


VTAM package you are running: 

IST14971 VTAM FUNCTIONAL SUPPORT LEVEL IS package_name 

lf you enter a customer number and password that are not 
valid, this message is issued: 

ISTQO1 VTAM START REJECTED — INVALID CUSTNO AND VTAMPW 


For explanations of these messages, see VTAM Messages 
and Codes. 
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VTAM Client/Server Functions 


VTAM Client/Server includes programming interfaces for 
network management, security, and application programs, 
such as CICS, VTAM record application programs, and 
VTAM LU 6.2 application programs. 


APPN support through integrated communication adapters 
(ICAs) allows APPN connections for switched and non- 
switched type 2.1 nodes as APPN nodes in a token-ring, 
X.25, or SDLC X.21 network. 


VM users enjoy an additional benefit: installing with the 
VMSES/E tool. Now you can use this tool to install and 
maintain VTAM. 


Connectivity 


¢ To NCP (connection only, no ownership) 
— Parallel transmission groups (TGs) 
— Transmission priorities 
e To the IBM 3174 Establishment Controller 
¢ To the IBM 3172 Interconnect Controller 
— Token-ring networks 
— Ethernet networks 
— Fiber distributed data interface (FDDI) lines 
— IBM 3710 Network Controller 
— Local SNA devices 
— Local non-SNA devices attached to the IBM 3272 
Local Control Unit 
e To channels 
~ Channel Data Link Control connections 
Enterprise Systems Connection (ESCON*) 
- For communication controllers 
- For host attachments 
— ESCON non-SNA 3174 channels for hosts 
For APPN host-to-host channels only 
- Multipath channels 
- IBM 3088 Channel Multiplexor 
e To integrated communication adapters (ICAs) 
— X.25 networks 
— Token-ring networks 
— Ethernet networks 
— Fiber distributed data interface (FDDI) lines 
— Synchronous data link control (SDLC) lines 
— Switched lines 


Installation and Service Enhancements 
e Installing VTAM using the VMSES/E tool 


Installation-Wide Exit Routine Enhancements 


e Session accounting exit routine 
e Session authorization exit routine 
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LU 6.2 and Record Application Program Interface 
(API) Enhancements 


Conversation status — 

Deallocate request processing 

Full-duplex 

LU 6.2 programming macroinstructions (APPCCMDs) 
Receive immediate 

VTAM record API macroinstructions 


Network Dynamics 


APPN 
— Class-of-service table 


— Connection network (including APPN over ICA con- 
nections) 


— End node (including APPN over ICA connections) 
— Host-to-host channel 


— Network node (including APPN over ICA con- 
nections) 


Controlling the use of logon mode table entry, 
ISTCOSDF 


Dynamic configuration of channel-attached devices 


Dynamic definition of a switched or token-ring 
connection 


Dynamic definition of, independent LUs 
Dynamic modification of DLOGMOD operand 
Dynamic replacement of logmode tables 
Dynamic replacement of class-of-service tables 
Dynamic reconfiguration 


Expanded dial information 


Operator Interface Enhancements 


Centralized support for modifiable start options (MODIFY 
VTAMOPTS) 


DISPLAY command enhancements 

Display of VTAM start options (DISPLAY VTAMOPTS) 
Inactivating LUs in a pending-notify state 

Verification of VTAMLST syntax 

Online message facility (added for VM) 

Support for message level 

Support for program operators 

User-defined message flooding prevention table 

VTAM support for IBM Command Tree/2 (added for VM) 


Performance Enhancements 


Authorized transmission priority for LEN connections 


Automatic termination of sessions using too much of 10 
buffer pool (HOTIOTRM) | 


Session limits for switched resources 


Problem Diagnosis 


e Analysis tools for an externally recorded VTAM internal 
trace (added for VM) 


e Buffer contents trace enhancements 


¢ Capturing of diagnosis information with First Failure 
Support Technology (added for VM) 


¢ Communication network management trace (added for 
VM) 
e Display of active traces 


e VIT enhancements 


Security 


e Call security verification for switched subareas 


SNA Subarea 


e Class-of-service table 

Substitute COS name 

Links to one or more NCPs 

SSCP-to-LU sessions 

SSCP-to-PU sessions 

Non-native network connection 

Logon interpret table and logon interpret routine 


System and Configuration Management 


e Expanded addressing pool 

e Network-qualified names 

e Specifying search order for locating switched PUs 
e 31-bit addressing capability 


VM/SNA Console Support (VSCS) Enhancements 
(VM) 


¢ Controlling pending requests 

e Display of dynamic changes to system status field 
e Logon and disconnect improvements 

e Network-qualified names 


VTAM Client/Server Restrictions 


In VTAM Client/Server, some keywords, definition state- 
ments, start options, and operands on commands are not 
supported. This section lists what is not supported and 
shows the messages you receive if you try to use something 
that is not supported. 


Definition Statements 


If you use these keywords on definition statements: 


e LOGAPPL 
¢ VRTG 

¢ VRTGCPCP 
¢ DLURNAME 
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e SRCOUNT 
e SRTIMER 

e CMPAPPLI 
e CMPAPPLO 


these messages are issued: 


IST3221 CONFIGURATION configname ERROR IGNORED — INVALID PARAMETER 
IST323I LABEL= labelname -— MACRO TYPE = macrotype — KEYWORD = keyword 
IST3141 END 


If you use the DISCNT=DELAY keyword, these messages 
are issued: 


IST3221 CONFIGURATION configname ERROR IGNORED — INVALID VALUE 
IST323I LABEL= labelname -— MACRO TYPE = macrotype — KEYWORD = DISCNT 
IST314I END 


If you use these definition statements: 


e CDRM 
e NCP 
e LUGROUP 


this message is issued: 
1ST1330I type CANNOT BE ACTIVATED FROM THIS NODE 


Commands 


If you use these operands on the MODIFY RESOURCE 
command: 


e DISCNTIM 
e SRCLEAR 
e SRCOUNT 
e SRTIMER 


If you use these operands on the VARY ACT command: 


e LOGON 
e VRTGCPCP 


this message is issued: 
IST452I parameter PARAMETER EXTRANEOUS 


lf you use the SAVE=YES operand on the MODIFY TRACE 
command, this message is issued: 


IST453I parameter PARAMETER VALUE INVALID 


If you issue these commands: 


e MODIFY USERVAR 
e VARY LOGON 
e MODIFY COMPRESS 


this message is issued: 
ISTO39I command FAILED — CANNOT IDENTIFY COMMAND TYPE 
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Start Options 


If you use these start options: 


e AUTOTI 
e AUTORTRY 


e SNVC 

e CDSERVR 
e GWSSCP 
e IOPURGE 
e VRTG 

e VRTGCPCP 
e SRCHRED 
e SRCOUNT 
e SRTIMER 
e CMPVTAM 
e CMPMIPS 
e DISCNTIM 


this message is issued: 
IST4481 option OPTION IGNORED — NO LONGER SUPPORTED 


Messages IST663I and IST985I 


Message IST663I runame REQUEST FAILED, SENSE=1003000 
indicates that this VTAM package does not support 
dependent LU servers or requesters. 


Message IST985I USER EXIT exitname option FAILED — 
CODE 2F indicates that this package supports only the session 
accounting exit routine and the session authorization exit 
routine. This package does not support other installation- 
wide exit routines. 


Persistent Session Support 


When an application program opens its application control 
block (ACB) with a request for persistent sessions, VTAM 
allows the ACB to open, but VTAM ignores the request for 
persistence. VTAM updates the application managements 
services vector list (AMSVL) for the application program to | 
indicate that VTAM does not support persistent sessions 
when running VTAM Client/Server. 


VTAM MultiDomain Functions 


If your network includes more than one domain, we recom- 
mend you consider VTAM MultiDomain. VTAM MultiDomain 
allows VTAM to own an NCP and gives you APPN and 
subarea functions not available in VTAM Client/Server. 


VTAM MultiDomain includes all of the functions listed under 
“VTAM Client/Server Functions” on page 2, in addition to the 
functions listed here. 
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Connectivity 


e To channels 
— Channel-to-channel 
— Multipath channels 
— IBM 3088 Channel Multiplexor 
¢ To NCP | 
— Multilink transmission groups between NCPs 


Installation-Wide Exit Routines 
¢ Session management exit routine 
e Virtual route selection exit routine 
e Virtual route pacing window size calculation exit routine 


¢ Configuration services exchange identification (XID) exit 
routine 


e Selection of definitions for dependent LUs (SDDLU) exit 
routine 


e Command verification exit routine 
e USERVAR exit routine 


e Directory services management exit routine 


Network Dynamics 


¢ APPN 
— Composite network node routing 
— Interchange node (full function) 
— Migration data host node (full function) 
Definition of spare SDLC lines 
Dynamic adjacent SSCP tables 
Dynamic definition of dependent LUs 
Dynamic switched definition facility 
User variables (USERVAR) 


Performance Enhancements 
e Automatic logon 


e Automatic recovery from an outstanding session request 
(LOPURGE) 


e Delayed disconnection 
e Software data compression 


e Enhanced software and hardware data 
compression (added for VSE) 


e Non-disruptive deactivation of cross-domain resource 
managers 
Problem Diagnosis 


¢ Saving the TRACE command for future use 


SNA Subarea 


e Cross-domain resource manager 
e Ownership of one or more NCPs 


System and Configuration Management 


e Adjacent SSCP lists for cross-domain resources 

e Dependent LU server 

¢ Dependent LU requester code for OS/2* 

e Support for frame relay networks over token ring con- 
nections 

e Virtual-route-based transmission groups 


VTAM MultiDomain Restrictions 


In VTAM MultiDomain, some keywords, start options, and 
operands on commands are not supported. This section lists 
what is not supported and shows the messages you receive 
if you try to use something that is not supported. 


Definition Statements 


If you use these keywords on definition statements: 


e SRCOUNT 
e SRTIMER 


these messages are issued: 


IST322I CONFIGURATION configname ERROR IGNORED — INVALID PARAMETER 
IST3231I LABEL= labelname -— MACRO TYPE = macrotype — KEYWORD = keyword 
IST314I1I END 


If you use these operands on the MODIFY RESOURCE 
command: 


e SRCLEAR 
e SRCOUNT 
e SRTIMER 


this message is issued: 
IST452I parameter PARAMETER EXTRANEOUS 


Start Options 


If you use these start options: 


e BN 
BNDYN 
BNORD 
SNVC 
CDSERVR 
GWSSCP 
SRCHRED 
SRCOUNT 
e SRTIMER 


this message is issued: 
IST448I option OPTION IGNORED — NO LONGER SUPPORTED 


Persistent Session Support 


When an application program opens its application control 
block (ACB) with a request for persistent sessions, VTAM 
allows the ACB to open, but VTAM ignores the request for 
persistence. VTAM updates the application managements 
services vector list (AMSVL) for the application program to 
indicate that VTAM does not support persistent sessions 
when running VTAM MultiDomain. 


VTAM InterEnterprise Functions 


If you need interconnection to other networks, VTAM 
InterEnterprise gives you the functions required for cross- 
network communication. VTAM InterEnterprise lets you 
connect to other networks with border nodes and SNA 
network interconnection (added for VM). 


VTAM InterEnterprise includes all of the functions listed 
under “VTAM Client/Server Functions” on page 2 and “VTAM 
MultiDomain Functions” on page 4, in addition to the func- 
tions listed here. 
Network Dynamics 
e APPN 
— Central directory server 


— Eliminating and reducing searches for unavailable 
resources 


— Multiple network connectivity (border node) 
Record Application Program Interface (API) 
Enhancements 

e Persistent LU-LU sessions (added for VSE) 


SNA Subarea 


e SNA network interconnection (added for VM) 
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